Apple Developer Connection Student Program/ADC Tools Sampler CD Disk 3 1999.iso/Metrowerks CodeWarrior/Java Support/Java_Source/Java2/src/java/security/Signer.java

Java Source | 1999-05-28 | 4.6 KB | 171 lines | [TEXT/CWIE]

/*
 * @(#)Signer.java    1.34 98/09/24
 *
 * Copyright 1996-1998 by Sun Microsystems, Inc.,
 * 901 San Antonio Road, Palo Alto, California, 94303, U.S.A.
 * All rights reserved.
 *
 * This software is the confidential and proprietary information
 * of Sun Microsystems, Inc. ("Confidential Information").  You
 * shall not disclose such Confidential Information and shall use
 * it only in accordance with the terms of the license agreement
 * you entered into with Sun.
 */

package java.security;

import java.io.*;

/**
 * This class is used to represent an Identity that can also digitally
 * sign data.
 *
 * <p>The management of a signer's private keys is an important and
 * sensitive issue that should be handled by subclasses as appropriate
 * to their intended use.
 *
 * @see Identity
 *
 * @version 1.34 99/03/26
 * @author Benjamin Renaud
 *
 * @deprecated This class is no longer used. Its functionality has been
 * replaced by <code>java.security.KeyStore</code>, the
 * <code>java.security.cert</code> package, and
 * <code>java.security.Principal</code>.
 */
public abstract class Signer extends Identity {

    /**
     * The signer's private key.
     *
     * @serial
     */
    private PrivateKey privateKey;

    /**
     * Creates a signer. This constructor should only be used for
     * serialization.
     */
    protected Signer() {
    super();
    }


    /**
     * Creates a signer with the specified identity name.
     *
     * @param name the identity name.
     */
    public Signer(String name) {
    super(name);
    }

    /**
     * Creates a signer with the specified identity name and scope.
     *
     * @param name the identity name.
     *
     * @param scope the scope of the identity.
     *
     * @exception KeyManagementException if there is already an identity
     * with the same name in the scope.
     */
    public Signer(String name, IdentityScope scope)
    throws KeyManagementException {
    super(name, scope);
    }

    /**
     * Returns this signer's private key.
     *
     * <p>First, if there is a security manager, its <code>checkSecurityAccess</code>
     * method is called with <code>"getSignerPrivateKey"</code>
     * as its argument to see if it's ok to return the private key.
     *
     * @return this signer's private key, or null if the private key has
     * not yet been set.
     *
     * @exception  SecurityException  if a security manager exists and its
     * <code>checkSecurityAccess</code> method doesn't allow
     * returning the private key.
     *
     * @see SecurityManager#checkSecurityAccess
     */
    public PrivateKey getPrivateKey() {
    check("getSignerPrivateKey");
    return privateKey;
    }

   /**
     * Sets the key pair (public key and private key) for this signer.
     *
     * <p>First, if there is a security manager, its <code>checkSecurityAccess</code>
     * method is called with <code>"setSignerKeyPair"</code>
     * as its argument to see if it's ok to set the key pair.
     *
     * @param pair an initialized key pair.
     *
     * @exception InvalidParameterException if the key pair is not
     * properly initialized.
     * @exception KeyException if the key pair cannot be set for any
     * other reason.
     * @exception  SecurityException  if a security manager exists and its
     * <code>checkSecurityAccess</code> method doesn't allow
     * setting the key pair.
     *
     * @see SecurityManager#checkSecurityAccess
     */
    public final void setKeyPair(KeyPair pair)
    throws InvalidParameterException, KeyException {
    check("setSignerKeyPair");
    final PublicKey pub = pair.getPublic();
    PrivateKey priv = pair.getPrivate();

    if (pub == null || priv == null) {
        throw new InvalidParameterException();
    }
    try {
        AccessController.doPrivileged(new PrivilegedExceptionAction() {
        public Object run() throws KeyManagementException {
            setPublicKey(pub);
            return null;
        }
        });
    } catch (PrivilegedActionException pae) {
        throw (KeyManagementException) pae.getException();
    }
    privateKey = priv;
    }

    String printKeys() {
    String keys = "";
    PublicKey publicKey = getPublicKey();
    if (publicKey != null && privateKey != null) {
        keys = "\tpublic and private keys initialized";

    } else {
        keys = "\tno keys";
    }
    return keys;
    }

    /**
     * Returns a string of information about the signer.
     *
     * @return a string of information about the signer.
     */
    public String toString() {
    return "[Signer]" + super.toString();
    }

    private static void check(String directive) {
    SecurityManager security = System.getSecurityManager();
    if (security != null) {
        security.checkSecurityAccess(directive);
    }
    }

}